home *** CD-ROM | disk | FTP | other *** search
/ Aminet 19 / Aminet 19 (1997)(GTI - Schatztruhe)[!][Jun 1997].iso / Aminet / comm / news / DWdecode.readme < prev    next >
Text File  |  1997-05-03  |  7KB  |  182 lines
  1. Short:    (v1.02) Very SMART mass decoder of USENET binaries
  2. Author:   dwhiting@europa.com  (Dick Whiting)
  3. Uploader: dwhiting@europa.com  (Dick Whiting)
  4. Version:  V1.02 Minor fixes plus add BinHex decoding
  5. Type:     comm/news
  6. Replaces: comm/news/DWdecode*
  7.  
  8.  
  9. REQUIREMENTS: 
  10. -------------
  11.  
  12. You will need several programs/libraries from Aminet:
  13.  
  14.    RexxArpLib by Willy Langeveld  - util/rexx/ral3p3.lha
  15.  
  16.    FlashFind  by Frank Würkner    - util/cli/FlashFind1.2.lha
  17.  
  18.    A UUdecoder
  19.      e.g. UUout by Nicolas Dade   - util/arc/uuOut114.lha
  20.      
  21.    A Base64 decoder 
  22.      e.g. Base64coders by Edmund Vermeulen - comm/mail/Base64coders.lha
  23.  
  24.    A BinHex decoder 
  25.      e.g. binhex374 by Nik Soggia - util/arc/binhex374.lha
  26.  
  27.    And, of course, some Use Net files with encoded binaries;)
  28.  
  29. FILES INCLUDED IN THIS ARCHIVE:
  30.  
  31.    DWdecode               - the REAL program.
  32.    DWdecode.Base64.Types  - means of identifying Base64 first lines
  33.    DWdecode.Binary.Types  - means of identifying filenames in subject
  34.    DWdecode.Doc           - text format of documentation
  35.    DWdecode.Encode.Types  - MIME encoding types
  36.    DWdecode.Guide         - Amiga guide documentation
  37.    DWdecode.Guide.info    - info file for guide
  38.    DWdecode.Prefs         - a starter preference file
  39.    DWdecode.Readme        - copy of the Aminet readme file
  40.    DWdecode.Section.Types - describes Section lines of UUencoded files
  41.    DWdecode.Skip.Froms    - allows for filtering based on From: lines
  42.    DWdecode.Skip.Subjects - allows for filtering based on Subject: lines 
  43.    Samples/....           - subdirectory with example script(s)
  44.  
  45.    arexxqsort.lha         - handles sorting of stem variables.
  46.        by Willy Langeveld - originally found on Aminet 
  47.  
  48.  
  49. BASICS: 
  50. -------
  51.  
  52. This program does MASS decoding of Use Net files. It decodes ALL binaries
  53. that it is able to recognize, which is most;) from the source directory
  54. and optionally from ALL subdirectories as well.
  55.  
  56.  
  57. WHAT IT DOES:
  58. -------------
  59.  
  60. It uses information from MIME content lines, section lines, begin lines
  61. and (if it must) the subject line to determine what kind of encoding is
  62. used and which parts go together. It reports on files that have missing
  63. parts and on ones that it is unable to obtain complete information for.   
  64.  
  65. It handles either single directories or can handle COMPLETE directory trees.
  66.  
  67. It handles files with SINGLE & MULTIPLE UUencoded OR Base64 binaries 
  68. within them and Multipart UUencoded or Base64 files.
  69.  
  70. It handles files with APPLE/DOUBLE format. My logic uses the LAST file 
  71. of a given name within a SINGLE input file. This forces the APPLE portion
  72. to be considered a duplicate and not processed.
  73.  
  74. It allows you to filenote the decoded binaries with a variety of
  75. substitution values as well as literals. 
  76.  
  77. It is quite 'smart' and generally can figure out most files.
  78.  
  79. It is highly configurable and using external files can 'learn'.
  80.  
  81. It should work with almost ANY Base64 and UU decoder.
  82.  
  83. It allows for filtering based on From: and/or Subject: lines.
  84.  
  85. It allows for deleting input files after decoding, deleting duplicates, 
  86. deleting input files based on From: &/or Subject: lines, deleting files
  87. that have ONLY text in them, and deleting files based on their age.    
  88.  
  89. Reporting can be tailored by setting/unsetting a variety of switches on the
  90. command line or in the prefs file.
  91.  
  92. ------------------------------------------------------------------
  93.  
  94.   v1.02 Fixes:        
  95.  
  96.       Finally, I HOPE, have fixed adding libraries during init. Several
  97.       people told me I hadn't... must have been some other program;)
  98.  
  99.   v1.01 Fixes:        
  100.  
  101.       Discovered that RexxTricks.Library uses the SAME function name as 
  102.          QuickSort, BUT in a different format. 
  103.          Added code to test if RexxTricks is present and to call QSORT 
  104.          in that format if necessary instead of W.L's. 
  105.          The SORTS are faster if RexxTricks.Library is NOT present,
  106.          so try to do decoding prior to anything that might add it.
  107.  
  108.       Can NOW place in directory named DWDECODE and have it WORK!! Really 
  109.          stupid error - thanks to Paul Copsey for finding this one.
  110.  
  111.       Now correctly deletes parts greater than 1 of multipart input files
  112.          when DeleteDups is specified. 
  113.  
  114.       If DWdecode MUST resort to using just Subject: line information will
  115.          now consider the SAME partname appearing multiple times in the 
  116.          subject, IFF it is the only name present, as THE name to use.
  117.  
  118.       Added support for BinHex files (only 1/1 type files). 
  119.          New variables w/defaults: 
  120.             BinHexCmd='BHD data=%DF %SF'
  121.             BinCmdFail=20
  122.  
  123.       Removed unused variable DumpB64Files from preferences/help.
  124.  
  125.       Now handles PC type lines with Ctrl-M's
  126.  
  127.       Now filenotes output files containing parens in their names
  128.  
  129.       Now writes FileNote errors to log/console as requested
  130.  
  131.       Made maximum filename length on report = 30 characters.          
  132.  
  133.       Added message referring user to logfile for errors.
  134.  
  135.       Added Guide format of 'documentation'.
  136.  
  137.  
  138.   v1.0  Initial Release
  139.  
  140. ------------------------------------------------------------------
  141.  
  142. I homeschool my kids and they would love a postcard from where EVER you live. 
  143. Instant Geography Lesson;)      
  144.                                                                           
  145. POSTCARDS:    Dick Whiting                                                
  146.               28590 S. Beavercreek Rd.                                    
  147.               Mulino, Oregon 97042                                        
  148.               USA                                                         
  149.                                                                           
  150. Bug Reports, etc:                                                         
  151.                                                                           
  152. Dick Whiting <dwhiting@europa.com>                   
  153. April 02, 1997
  154.                                                                           
  155. ------------------------------------------------------------------
  156.  
  157.  
  158. ============================= Archive contents =============================
  159.  
  160. Original  Packed Ratio    Date     Time    Name
  161. -------- ------- ----- --------- --------  -------------
  162.     8234    8234  0.0% 01-Jan-97 18:13:20 +arexxqsort.lha
  163.   166517   31154 81.2% 01-Apr-97 14:34:20 +DWdecode
  164.     1776     260 85.3% 31-Dec-96 15:46:06 +DWdecode.Base64.Types
  165.     2830     612 78.3% 31-Dec-96 15:52:22 +DWdecode.Binary.Types
  166.      478     236 50.6% 25-Feb-97 21:36:32 +DWdecode.guide.info
  167.     5850    1345 77.0% 08-Jan-97 01:05:08 +DWdecode.Section.Types
  168.     2816     587 79.1% 31-Dec-96 15:55:10 +DWdecode.Encode.Types
  169.    55607   13282 76.1% 01-Apr-97 14:38:48 +DWdecode.guide
  170.     3880     757 80.4% 28-Mar-97 23:22:10 +DWdecode.Prefs
  171.     5894    2389 59.4% 28-Mar-97 23:58:28 +DWdecode.ReadMe
  172.     1944     405 79.1% 02-Jan-97 17:01:02 +DWdecode.Skip.Froms
  173.     2916     537 81.5% 02-Jan-97 17:03:32 +DWdecode.Skip.Subjects
  174.    53051   12631 76.1% 01-Apr-97 14:34:46 +DWdecode.Doc
  175.        0       0  0.0% 02-Jan-97 17:37:34 +DWdecode.Trap.Encodes
  176.        0       0  0.0% 02-Jan-97 17:04:32 +DWdecode.Trap.Sections
  177.      628     251 60.0% 02-Jan-97 16:56:26 +SAMPLES.info
  178.      828     313 62.1% 02-Jan-97 16:59:18 +DoArts
  179.     1778     751 57.7% 04-Jan-97 00:52:24 +fixfilenotes
  180. -------- ------- ----- --------- --------
  181.   315027   73744 76.5% 02-Apr-97 04:51:20   18 files
  182.